package com.qf.springboot.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
 * Swagger配置
 *  // <beans
 * @author zjw
 */
@Configuration
@EnableSwagger2
public class Swagger2Config {

    /**
     * Swagger2在线文档的描述信息
     *  // <bean  id="方法名"  class="方法返回结果类型"   ， 方法参数的内容，代表ref="" 从Spring容器拿到的实例
     * @return
     */
    @Bean
    public ApiInfo apiInfo(){
        ApiInfo apiInfo = new ApiInfoBuilder()
                .title("Swagger2在线文档入门")
                .description("性感在线测试接口！")
                .version("v1.0.0")
                .contact(new Contact("zjw", "http://www.baidu.com", "zjw_xxxx@1000.com"))
                .build();
        return apiInfo;
    }

    /**
     * 指定哪些包下的controller和哪些路径的资源需要生成文档在Swagger中
     * @return
     */
    @Bean
    public Docket docket(ApiInfo apiInfo){
        Docket docket = new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo)
                .select()
                .build();
        return docket;
    }

}
